<html lang="en">

<head>
  <meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>JDK Souce --- Comparable - bravo</title>
<link rel="shortcut icon" href="https://JoyZgq.github.io/favicon.ico">
<link href="https://cdn.jsdelivr.net/npm/remixicon@2.2.0/fonts/remixicon.css" rel="stylesheet">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/animate.css@3.7.2/animate.min.css">
<link rel="stylesheet" href="https://JoyZgq.github.io/media/css/tailwind.css">
<link rel="stylesheet" href="https://JoyZgq.github.io/styles/main.css">
<link rel="alternate" type="application/atom+xml" title="JDK Souce --- Comparable - bravo - Atom Feed" href="https://JoyZgq.github.io/atom.xml">


  <script async src="https://www.googletagmanager.com/gtag/js?id=UA-164181119-1"></script>
  <script>
    window.dataLayer = window.dataLayer || [];
    function gtag(){dataLayer.push(arguments);}
    gtag('js', new Date());
  
    gtag('config', 'UA-164181119-1');
  </script>
    

  <meta name="description" content="概述😜😋🤡😣
  此接口对实现它的每个类的对象强加一个总排序。 这种排序被称为类的自然顺序 ，类的compareTo方法被称为其自然比较方法 。
  实现此接口的对象的列表（和数组）可以由Collections.sort （和Arr..." />
  <meta property="og:title" content="JDK Souce --- Comparable - bravo">
  <meta property="og:description" content="概述😜😋🤡😣
  此接口对实现它的每个类的对象强加一个总排序。 这种排序被称为类的自然顺序 ，类的compareTo方法被称为其自然比较方法 。
  实现此接口的对象的列表（和数组）可以由Collections.sort （和Arr..." />
  <meta property="og:type" content="articles">
  <meta property="og:url" content="https://JoyZgq.github.io/post/jdk-souce-comparable/" />
  <meta property="og:image" content="https://JoyZgq.github.io/post-images/jdk-souce-comparable.webp">
  <meta property="og:image:height" content="630">
  <meta property="og:image:width" content="1200">
  <meta name="twitter:title" content="JDK Souce --- Comparable - bravo">
  <meta name="twitter:description" content="概述😜😋🤡😣
  此接口对实现它的每个类的对象强加一个总排序。 这种排序被称为类的自然顺序 ，类的compareTo方法被称为其自然比较方法 。
  实现此接口的对象的列表（和数组）可以由Collections.sort （和Arr...">
  <meta name="twitter:card" content="summary_large_image">
  <link rel="canonical" href="https://JoyZgq.github.io/post/jdk-souce-comparable/">

  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/photoswipe@4.1.3/dist/photoswipe.css">
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/photoswipe@4.1.3/dist/default-skin/default-skin.css">
 
  
    <link rel="stylesheet" href="https://JoyZgq.github.io/media/css/prism-github.css">
  

  
</head>

<body>
  <div class="antialiased flex flex-col min-h-screen" id="app">
    <a href="https://JoyZgq.github.io" class="fixed top-0 left-0 mt-4 bg-black text-white dark:text-gray-700 dark:bg-yellow-50 dark:hover:bg-black dark:hover:text-white inline-flex p-2 pl-8 hover:text-gray-700 hover:bg-yellow-50 font-bold z-10 transition-fast animated fadeInLeft">
      bravo
    </a>
    <div class="max-w-4xl w-full mx-auto">
      <div class="shadow-box bg-white dark:bg-gray-600 rounded-lg pt-32 md:pt-64 px-4 md:px-8 pb-8 animated fadeIn mb-8">
        <h1 class="text-5xl font-semibold leading-normal pb-8 mb-8 border-b-8 border-gray-700">
          JDK Souce --- Comparable
        </h1>
        
          <img src="https://JoyZgq.github.io/post-images/jdk-souce-comparable.webp" alt="JDK Souce --- Comparable" class="block w-full mb-8">
        
        <div class="mb-8 flex flex-wrap">
          <div class="text-gray-400 text-sm mr-4">2019-02-18 · 6 min read</div>
          
            <a href="https://JoyZgq.github.io/tag/ElQLiC5kr/" class="text-gray-700 text-sm border-b-2 border-dotted border-gray-200 hover:border-gray-600 transition-all duration-100 inline-flex mr-2">
              <i class="ri-hashtag"></i>
              interface
            </a>
          
            <a href="https://JoyZgq.github.io/tag/mfQ75zvRf/" class="text-gray-700 text-sm border-b-2 border-dotted border-gray-200 hover:border-gray-600 transition-all duration-100 inline-flex mr-2">
              <i class="ri-hashtag"></i>
              lang
            </a>
          
        </div>
        <div class="markdown mb-8" v-pre>
          <h3 id="概述">概述😜😋🤡😣</h3>
<p>  此接口对实现它的每个类的对象强加一个总排序。 这种排序被称为类的自然顺序 ，类的<strong>compareTo</strong>方法被称为其自然比较方法 。<br>
  实现此接口的对象的列表（和数组）可以由Collections.sort （和Arrays.sort ）自动排序。 实现该接口的对象，可以使用如在键sorted map或作为在元件sorted set ，而不需要指定一个comparator 。</p>
<p>  一类的自然排序C据说是与equals一致 ，当且仅当e1.compareTo(e2) == 0具有相同的布尔值e1.equals(e2) ，每e1和e2类C 。</p>
<blockquote>
<p>请注意， null不是任何类的实例， e.compareTo(null)应该抛出<code>NullPointerException</code>即使e.equals(null)返回false 。</p>
</blockquote>
<p>  <em><strong>强烈建议（尽管不是必需的）自然排序与equals一致。 这是因为没有显式比较器的有序集（和有序映射）在与自然排序与equals不一致的元素（或键）一起使用时表现得“奇怪”。 特别是，这样的有序集（或有序映射）违反了集合（或映射）的一般契约，它是根据equals方法定义的。</strong></em></p>
<p>  例如，如果将两个键a和b (!a.equals(b) &amp;&amp; a.compareTo(b) == 0)到不使用显式比较器的有序集合中，则第二个add操作返回false（并且有序集的大小不会增加），因为a和b是等效的从排序集的角度来看。<br>
  实际上，所有实现Comparable Java核心类都具有与equals一致的自然排序。 一个例外是java.math.BigDecimal ，其自然排序等同BigDecimal具有相同值和不同精度的BigDecimal对象（例如4.0和4.00）。<br>
对于数学倾向，定义给定类C的自然排序的关系是：</p>
<pre><code class="language-java">   {(x, y) such that x.compareTo(y) &lt;= 0}.  
</code></pre>
<p>此总订单的商是：</p>
<pre><code class="language-java">   {(x, y) such that x.compareTo(y) == 0}.  
</code></pre>
<p>  它从合同紧跟compareTo ，该商数是一个等价关系 C ，那自然排序是全序 C 。 当我们说类的自然排序与equals一致时 ，我们的意思是自然排序的商是由类equals(Object)方法定义的等价关系：</p>
<pre><code class="language-java">  {(x, y) such that x.equals(y)}. 
</code></pre>
<h4 id="compareto-方法">CompareTo 方法🤓😟😤😧</h4>
<blockquote>
<p>将此对象与指定的对象进行比较以获得顺序。 返回负整数，零或正整数，因为此对象小于，等于或大于指定对象。</p>
</blockquote>
<p>  实现程序必须确保sgn(x.compareTo(y)) == -sgn(y.compareTo(x))所有x和y 。 （这意味着x.compareTo(y) IFF必须抛出一个异常y.compareTo(x)抛出一个异常。）</p>
<p>  实现者还必须确保该关系是可传递的： (x.compareTo(y) &gt; 0 &amp;&amp; y.compareTo(z) &gt; 0)意味着x.compareTo(z) &gt; 0 。</p>
<p>  最后，实现者必须确保x.compareTo(y)==0暗示sgn(x.compareTo(z)) == sgn(y.compareTo(z)) ，对于所有z 。</p>
<p>  强烈建议，但不严格要求(x.compareTo(y)==0) == (x.equals(y)) 。 一般来说，任何实现Comparable接口且违反此条件的类都应清楚地表明这一事实。 推荐的语言是“注意：此类具有与equals不一致的自然顺序。”</p>
<p>  在前面的描述中，符号sgn( 表达 )表示数学符号函数，其被定义为返回之一-1 ， 0 ，或1分别根据表达式的值是否为负，零或正。</p>
<h4 id="异常️️">异常☠️☠️💀👻</h4>
<p>*<code>NullPointerException</code> - 如果指定的对象为null<br>
*<code>ClassCastException</code> - 如果指定对象的类型阻止将其与此对象进行比较。</p>
<hr>
<details>
<summary>所有已知实现类</summary>
AbstractChronology ，AbstractRegionPainter.PaintContext.CacheMode ， AccessMode ， AclEntryFlag ， AclEntryPermission ， AclEntryType ， AssociationChangeNotification.AssocChangeEvent ， AttributeTree.ValueKind ， Authenticator.RequestorType ， BigDecimal ， BigInteger ， Boolean ， Byte ， ByteBuffer ， Calendar ， CardTerminals.State ， CatalogFeatures.Feature ， CertPathValidatorException.BasicReason ， Character ， Character.UnicodeScript ， CharBuffer ， Charset ， ChronoField ， ChronoUnit ， ClientInfoStatus ， CollationKey ， Collector.Characteristics ， Component.BaselineResizeBehavior ， CompositeName ， CompoundName ， ConversionComparator.Comparison ， CRLReason ， CryptoPrimitive ， Date ， Date ， DayOfWeek ， Desktop.Action ， Diagnostic.Kind ， Diagnostic.Kind ， Dialog.ModalExclusionType ， Dialog.ModalityType ， Doclet.Option.Kind ， DocletEnvironment.ModuleMode ， DocTree.Kind ， DocumentationTool.Location ， Double ， DoubleBuffer ， DrbgParameters.Capability ， DropMode ， Duration ， ElementKind ， Elements.Origin ， ElementType ， Enum ， File ， FileTime ， FileVisitOption ， FileVisitResult ， Float ， FloatBuffer ， FocusEvent.Cause ， FormatStyle ， Formatter.BigDecimalLayoutForm Formatter.BigDecimalLayoutForm ， FormSubmitEvent.MethodType ， GraphicsDevice.WindowTranslucency ， GregorianCalendar ， GroupLayout.Alignment ， HandlerResult ， HijrahChronology ， HijrahDate ， HijrahEra ， HttpClient.Redirect ， HttpClient.Version ， InquireType ， Instant ， IntBuffer ， Integer ， IsoChronology ， IsoEra ， JapaneseChronology ， JapaneseDate ， JavaFileObject.Kind ， JConsoleContext.ConnectionState ， JDBCType ， JTable.PrintMode ， KeyRep.Type ， LambdaExpressionTree.BodyKind ， LanguageVersion ， LayoutStyle.ComponentPlacement ， LdapName ， LinkOption ， LocalDate ， LocalDateTime ， Locale.Category ， Locale.FilteringMode ， Locale.IsoCountryCode ， LocalTime ， Long ， LongBuffer ， MappedByteBuffer ， MemberReferenceTree.ReferenceMode ， MemoryType ， MinguoChronology ， MinguoDate ， MinguoEra ， Modifier ， ModuleDescriptor ， ModuleDescriptor.Exports ， ModuleDescriptor.Exports.Modifier ， ModuleDescriptor.Modifier ， ModuleDescriptor.Opens ， ModuleDescriptor.Opens.Modifier ， ModuleDescriptor.Provides ， ModuleDescriptor.Requires ， ModuleDescriptor.Requires.Modifier ， ModuleDescriptor.Version ， ModuleElement.DirectiveKind ， ModuleTree.ModuleKind ， Month ， MonthDay ， MultipleGradientPaint.ColorSpaceType ， MultipleGradientPaint.CycleMethod ， NestingKind ， Normalizer.Form ， NumericShaper.Range ， ObjectInputFilter.Status ， ObjectName ， ObjectStreamField ， OffsetDateTime ， OffsetTime ， PeerAddressChangeNotification.AddressChangeEvent ， PKIXReason ， PKIXRevocationChecker.Option ， PosixFilePermission ， ProcessBuilder.Redirect.Type ， Proxy.Type ， PseudoColumnUsage ， QuitStrategy ， Rdn ， RecordingState ， ResolverStyle ， RetentionPolicy ， RoundingMode ， RowFilter.ComparisonType ， RowIdLifetime ， RowSorterEvent.Type ， Runtime.Version ， Short ， ShortBuffer ， SignStyle ， Snippet.Kind ， Snippet.Status ， Snippet.SubKind ， SocketFlow.Status ， SortOrder ， SourceCodeAnalysis.Completeness ， SourceVersion ， SSLEngineResult.HandshakeStatus ， SSLEngineResult.Status ， StackWalker.Option ， StandardCopyOption ， StandardLocation ， StandardNamespace ， StandardOpenOption ， StandardOperation ， StandardProtocolFamily ， String ， StringBuffer ， StringBuilder ， SwingWorker.StateValue ， System.Logger.Level ， Taglet.Location ， Taskbar.Feature ， Taskbar.State ， TaskEvent.Kind ， TextStyle ， ThaiBuddhistChronology ， ThaiBuddhistDate ， ThaiBuddhistEra ， Thread.State ， Time ， Timestamp ， TimeUnit ， TrayIcon.MessageType ， Tree.Kind ， Tree.Kind ， TypeKind ， URI URI ， UserSessionEvent.Reason ， UUID ， VarHandle.AccessMode ， VMOption.Origin ， Window.Type ， XPathEvaluationResult.XPathResultType ， Year ， YearMonth ， ZonedDateTime ， ZoneOffset ， ZoneOffsetTransition ， ZoneOffsetTransitionRule.TimeDefinition
</details>
        </div>
        <!-- Share to Twitter, Weibo, Telegram -->
        <div class="flex items-center">
          <div class="mr-4 flex items-center">
            <i class="ri-share-forward-line text-gray-500"></i>
          </div>
          <div class="px-4 cursor-pointer text-blue-500 hover:bg-blue-100 dark:hover:bg-gray-600 inline-flex" @click="shareToTwitter">
            <i class="ri-twitter-line"></i>
          </div>
          <div class="px-4 cursor-pointer text-red-500 hover:bg-red-100 dark:hover:bg-gray-600 inline-flex" @click="shareToWeibo">
            <i class="ri-weibo-line"></i>
          </div>
          <div class="px-4 cursor-pointer text-indigo-500 hover:bg-indigo-100 dark:hover:bg-gray-600 inline-flex" @click="shareToTelegram">
            <i class="ri-telegram-line"></i>
          </div>
        </div>
      </div>

      
        
          <div id="gitalk-container"></div>
        

        
      

      
        <div id="vlaine-comment"></div>
      

      <footer class="py-12 text-center px-4 md:px-0" v-pre>
  Powered by <a href="https://github.com/getgridea/gridea" target="_blank">Gridea</a>  Made by  <a href="https://github.com/JoyZgq" target="_blank">zgq</a> 🎈❤❤❤🌹
</footer>
    </div>

    <!-- TOC Container -->
    <div class="fixed right-0 bottom-0 mb-16 mr-4 shadow w-8 h-8 rounded-full flex justify-center items-center z-10 cursor-pointer bg-white dark:bg-gray-500 dark:text-gray-200 hover:shadow-lg transition-all animated fadeInRight" @click="showToc = true">
      <i class="ri-file-list-line"></i>
    </div>

    <div class="fixed right-0 top-0 bottom-0 overflow-y-auto w-64 bg-white dark:bg-gray-800 p-4 border-l border-gray-100 dark:border-gray-600 z-10 transition-fast" :class="{ '-mr-64': !showToc }">
      <div class="flex mb-4 justify-end">
        <div class="w-8 h-8 inline-flex justify-center items-center rounded-full cursor-pointer hover:bg-gray-200 dark:hover:bg-gray-600 transition-fast" @click="showToc = false">
          <i class="ri-close-line text-lg"></i>
        </div>
      </div>
      <div class="post-toc-container">
        <ul class="markdownIt-TOC">
<li>
<ul>
<li>
<ul>
<li><a href="#%E6%A6%82%E8%BF%B0">概述😜😋🤡😣</a>
<ul>
<li><a href="#compareto-%E6%96%B9%E6%B3%95">CompareTo 方法🤓😟😤😧</a></li>
<li><a href="#%E5%BC%82%E5%B8%B8%EF%B8%8F%EF%B8%8F">异常☠️☠️💀👻</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>

      </div>
    </div>

    <!-- Back to top -->
    <div class="fixed right-0 bottom-0 mb-4 mr-4 shadow w-8 h-8 rounded-full flex justify-center items-center z-10 cursor-pointer bg-white hover:shadow-lg transition-all dark:bg-gray-500 dark:text-gray-200" @click="backToUp" v-show="scrolled">
      <i class="ri-arrow-up-line"></i>
    </div>
  </div>

  <!-- Root element of PhotoSwipe. Must have class pswp. -->
<div class="pswp" tabindex="-1" role="dialog" aria-hidden="true">
  <!-- Background of PhotoSwipe. 
        It's a separate element as animating opacity is faster than rgba(). -->
  <div class="pswp__bg">
  </div>
  <!-- Slides wrapper with overflow:hidden. -->
  <div class="pswp__scroll-wrap">
    <!-- Container that holds slides. 
            PhotoSwipe keeps only 3 of them in the DOM to save memory.
            Don't modify these 3 pswp__item elements, data is added later on. -->
    <div class="pswp__container">
      <div class="pswp__item">
      </div>
      <div class="pswp__item">
      </div>
      <div class="pswp__item">
      </div>
    </div>
    <!-- Default (PhotoSwipeUI_Default) interface on top of sliding area. Can be changed. -->
    <div class="pswp__ui pswp__ui--hidden">
      <div class="pswp__top-bar">
        <!--  Controls are self-explanatory. Order can be changed. -->
        <div class="pswp__counter">
        </div>
        <button class="pswp__button pswp__button--close" title="Close (Esc)"></button>
        <button class="pswp__button pswp__button--fs" title="Toggle fullscreen"></button>
        <button class="pswp__button pswp__button--zoom" title="Zoom in/out"></button>
        <!-- Preloader demo http://codepen.io/dimsemenov/pen/yyBWoR -->
        <!-- element will get class pswp__preloader--active when preloader is running -->
        <div class="pswp__preloader">
          <div class="pswp__preloader__icn">
            <div class="pswp__preloader__cut">
              <div class="pswp__preloader__donut">
              </div>
            </div>
          </div>
        </div>
      </div>
      <div class="pswp__share-modal pswp__share-modal--hidden pswp__single-tap">
        <div class="pswp__share-tooltip">
        </div>
      </div>
      <button class="pswp__button pswp__button--arrow--left" title="Previous (arrow left)">
      </button>
      <button class="pswp__button pswp__button--arrow--right" title="Next (arrow right)">
      </button>
      <div class="pswp__caption">
        <div class="pswp__caption__center">
        </div>
      </div>
    </div>
  </div>
</div>

  <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script>
  <script src="https://JoyZgq.github.io/media/scripts/main.js"></script>
  
  <!-- Code Highlight -->
  
    <script src="https://JoyZgq.github.io/media/prism.js"></script>
    <script>
      Prism.highlightAll()
    </script>
  

  <script src="https://cdn.jsdelivr.net/npm/photoswipe@4.1.3/dist/photoswipe.min.js"></script>
  <script src="https://cdn.jsdelivr.net/npm/photoswipe@4.1.3/dist/photoswipe-ui-default.min.js"></script>
  <script>
    //拿到预览框架，也就是上面的html代码
    var pswpElement = document.querySelectorAll('.pswp')[0];
    //定义图片数组变量
    var imgitems;
    /**
    * 用于显示预览界面
    * @param index 图片数组下标
    */
    function viewImg(index) {
      //其它选项这里不做过多阐述，详情见官网
      var pswpoptions = {
        index: parseInt(index, 10), // 开始幻灯片索引。0是第一张幻灯片。必须是整数，而不是字符串。
        bgOpacity: 0.7, // 背景透明度，0-1
        maxSpreadZoom: 3, // 缩放级别，不要太大
      };
      //初始化并打开PhotoSwipe，pswpElement对应上面预览框架，PhotoSwipeUI_Default为皮肤，imgitems为图片数组，pswpoptions为选项
      var gallery = new PhotoSwipe(pswpElement, PhotoSwipeUI_Default, imgitems, pswpoptions);
      gallery.init()
    }
    /**
    * 用于添加图片点击事件
    * @param img 图片元素
    * @param index 所属下标（在imgitems中的位置）
    */
    function addImgClick(img, index) {
      img.onclick = function() {
        viewImg(index)
      }
    }
    /**
    * 轮询所有图片，获取src、width、height等数据，加入imgitems，并给图片元素添加事件
    * 最好在onload中执行该方法，本站因放在最底部，所以直接初始化
    * 异步加载图片可在图片元素创建完成后调用此方法
    */
    function initImg() {
      //重置图片数组
      imgitems = [];
      //查找class:markdown 下的所有img元素并遍历
      var imgs = document.querySelectorAll('.markdown img');
      for (var i = 0; i < imgs.length; i++) {
        var img = imgs[i];
        //本站相册初始为loading图片，真实图片放在data-src
        var ds = img.getAttribute("data-src");
        //创建image对象，用于获取图片宽高
        var imgtemp = new Image();
        //判断是否存在data-src
        if (ds != null && ds.length > 0) {
          imgtemp.src = ds
        } else {
          imgtemp.src = img.src
        }
        //判断是否存在缓存
        if (imgtemp.complete) {
          var imgobj = {
            "src": imgtemp.src,
            "w": imgtemp.width,
            "h": imgtemp.height,
          };
          imgitems[i] = imgobj;
          addImgClick(img, i);
        } else {
          console.log('进来了2')
          imgtemp.index = i;
          imgtemp.img = img;
          imgtemp.onload = function() {
            var imgobj = {
              "src": this.src,
              "w": this.width,
              "h": this.height,
            };
            //不要使用push，因为onload前后顺序会不同
            imgitems[this.index] = imgobj
            //添加点击事件
            addImgClick(this.img, this.index);
          }
        }
      }
    }
    //初始化
    initImg();
  </script>
  
    <script type="application/javascript" src="https://unpkg.com/valine"></script>
<script type="application/javascript">
  new Valine({
    el: '#vlaine-comment',
    appId: 'Sy2gsMvGcPQl3gTGsqqYsHW6-gzGzoHsz',
    appKey: 'IpsgegiMUNgRg7l5BVXk6EXM',
    pageSize: 10,
    notify: false,
    avatar: 'mp',
    verify: true,
    placeholder: '客官来都来了，不妨评论一下🌹🐱‍👤',
    visitor: true,
    highlight: false,
    recordIP: true,
  })
</script>
  
  
    
      <link rel="stylesheet" href="https://unpkg.com/gitalk/dist/gitalk.css">
<script type="application/javascript" src="https://unpkg.com/gitalk/dist/gitalk.min.js"></script>

<script type="application/javascript">

  var gitalk = new Gitalk({
    clientID: '83da62f594c23db993f3',
    clientSecret: '9aa795ad06ecb4133721f1acf047ecb1e4f295e8',
    repo: 'GitalkApp',
    owner: 'JoyZgq',
    admin: ['JoyZgq'],
    id: (location.pathname).substring(0, 49),      // Ensure uniqueness and length less than 50
    distractionFreeMode: false  // Facebook-like distraction free mode
  })

  gitalk.render('gitalk-container')

</script>

    
  
</body>

</html>